home *** CD-ROM | disk | FTP | other *** search
/ System Booster / System Booster.iso / Systemmonitors / DaLastAlert3 / Doc / DaLastAlert3.doc next >
Text File  |  1996-09-26  |  14KB  |  469 lines
  1.  
  2.  
  3.  
  4.  
  5.                        DaLastAlert 3 User Manual
  6.  
  7.          Copyright (C) 1995 Jørgen 'Da' Larsen (Posse Pro. DK)
  8.  
  9.  
  10. DaLastAlert 3
  11. **************
  12.  
  13. Introduction
  14. ============
  15.  
  16.    Are you tired of always having troubles with finding your pen and
  17. paper just to write down the last guru you got?  Now this problem is
  18. solved because I have written a 'small' and quick program that will
  19. show not only the last guru, but also a nice hint to what caused it!
  20.  
  21.    If you don't get the point of what this program can be used to then
  22. try to read the section What AS wrote about LA2.
  23.  
  24.  
  25. Copyright
  26. ==========
  27.  
  28.    This utility is released as FREEWARE.  This means that the program,
  29. and this user manual etc.  (the distribution) are freely distributable,
  30. but are also Copyright (c) Jørgen 'Da' Larsen.  The distribution must
  31. be kept together and there must only be charged a nominal fee to cover
  32. time and copying costs. Please also remember that no commercial usage
  33. is permitted without written permission from the author.
  34.  
  35. The distribution consists of:
  36.  
  37.      * DaLastAlert3              - Main program
  38.      * DaLastAlert3.info         - Icon (MWB & NewIcons)
  39.      
  40.      * DaLastAlert3-Check        - Starter program
  41.      * DaLastAlert3-Check.info   - Icon (MWB & NewIcons)
  42.      
  43.      * DaLastAlert3.alerts       - Alerts (textfile)
  44.      
  45.      * DaLastAlert3.guide        - Documentation in AmigaGuide© format
  46.      * DaLastAlert3.guide.info   - Icon
  47.      * DaLastAlert3.texinfo      - Documentation in TeXinfo format
  48.      * DaLastAlert3.texinfo.info - Icon
  49.      * DaLastAlert3.doc          - Documentation in ASCII format
  50.      * DaLastAlert3.doc.info     - Icon
  51.      
  52.      * DLA3.pic                  - Example Picture
  53.      * DLA3.pic.info             - Icon
  54.      
  55.      * Install-script            - Installer script
  56.      * Install.info              - Installer icon
  57.  
  58.  
  59. Disclaimer
  60. ===========
  61.  
  62.    The author is in no way liable for any changes made to any part of
  63. the package, or consequences thereof as he is in no way liable for
  64. damages or loss of data directly or indirectly caused by this software.
  65.  
  66.  
  67. System Requirements
  68. ====================
  69.  
  70.    DaLastAlert 3 requires Kickstart and Workbench 2.0 or higher to run!
  71.  
  72.  
  73. Installation
  74. =============
  75.  
  76. Just press the installer icon:
  77.  
  78.    * Install
  79.  
  80.    Please notice that the program can be installed anywhere you want,
  81. but please read Usage if you want my opinion (This is also the default
  82. in the chosen installer scripts) where DaLastAlert 3 would have it's
  83. best place.
  84.  
  85.  
  86. Usage
  87. ======
  88.  
  89. DaLastAlert3
  90. ------------
  91.  
  92.    The program can either be started from Workbench (just click the
  93. icon) or from CLI/Shell with the command:
  94.  
  95.      DaLastAlert3 [G=GURUNUMBER] [H=HELP/S] [N=NOGUI/S]
  96.      
  97.      Examples: > DaLastAlert3
  98.      
  99.                > Will popup - see picture below
  100.      
  101.      
  102.        or      > DaLastAlert3 $80000005
  103.      
  104.                > Will popup as above and show the below just in a juicy GUI
  105.      
  106.      
  107.        or      > DaLastAlert3 $80000005 NOGUI
  108.      
  109.                > DaLastAlert v3.0c (c) 1995 Jørgen 'Da' Larsen (Posse Pro. DK)
  110.                > Alert Number: $80000005
  111.                > Alert Task:   Unknown
  112.                > Alert Name:   ACPU_DivZero
  113.                > Spec. Alert:  Divide by zero
  114.                > Spec. Error:  Hardware/CPU
  115.      
  116.      
  117.        or      > DaLastAlert3 HELP
  118.      
  119.                > DaLastAlert v3.0c (c) 1995 Jørgen 'Da' Larsen (Posse Pro. DK)
  120.                > Syntax: DaLastAlert [G=GURU] [N=NOGUI] [H=HELP]
  121.                > Try:    DaLastAlert $80000004
  122.                >  or     DaLastAlert $80000004 NOGUI
  123.      
  124.      
  125.         +------------------------------------------------------------+
  126.         | | DaLastAlert 3                                          | |
  127.         +------------------------------------------------------------+
  128.         |                                                            |
  129.         | Alert Number :  0x80000005                                 |
  130.         | Alert Task   :  0x0800DDE8                                 |
  131.         |  -------------------------------------------------------   |
  132.         | Alert Name   :  ACPUG_DivZero                              |
  133.         | Spec. Alert  :  Hardware/CPU                               |
  134.         | Spec. Error  :  Divide by zero                             |
  135.         |                                                            |
  136.         |------------------------------------------------------------|
  137.         |                 _________________________________________  |
  138.         | Alert Number : |_________________________________________| | -+
  139.         |                                                            |  |
  140.         |------------------------------------------------------------|  |
  141.         |                                                            |  |
  142.         |      About              Last alert            Quit         |  |
  143.         |                                                            |  |
  144.         +------------------------------------------------------------+  |
  145.                  |                    |                  |              |
  146.                  |                    |                  |              |
  147.          Show ---+       Shows the ---+          Quit!---+     Input ---+
  148.          about           last alert                            string
  149.          requester       again
  150.  
  151.    DaLastAlert3 also reads ENV:DaLastAlert that tells DaLastAlert3
  152. where look for the textfile that contains the alert descriptions
  153. (Default: 'S:DaLastAlert3.alert').
  154.  
  155. Note
  156. ----
  157.  
  158.    The alert number shown by pressing 'Last alert' will of course be
  159. meaningless if you haven't had any Software failure's since you turned
  160. your system on.
  161.  
  162. DaLastAlert-Check
  163. -----------------
  164.  
  165.    If you can't get a postive reaction from DaLastAlert-Check it's
  166. probably because you haven't had a Guru/Software failure lately.  If
  167. you have had a Guru/Software failure then the string defined as EXEC
  168. will be executed.
  169.  
  170.    The program can either be started from Workbench (just click the
  171. icon) or from CLI/Shell. The options are as follows:
  172.  
  173.      WB Options
  174.      
  175.      EXEC - Where to find DaLastAlert3
  176.      
  177.      Example:  > EXEC=sys:Utilities/DaLastAlert3  (This is also the default)
  178.      
  179.      
  180.      CLI Options
  181.      
  182.      DaLastAlert3-Check [EXEC]
  183.      
  184.      Examples: > DaLastAlert3-Check
  185.      
  186.                > Executes sys:Utilities/DaLastAlert3
  187.      
  188.      
  189.        or      > DaLastAlert3-Check c:DaLastAlert3
  190.      
  191.                > Executes c:DaLastAlert3
  192.  
  193.    My suggestion to make DaLastAlert 3 as efficient as possible will be
  194. to place DaLastAlert3-Check in the WBStartup drawer (or maybe in the
  195. Startup-sequence) as this will allow you to recieve information on the
  196. last guru.
  197.  
  198.    If you follow my suggestion you will be free from troubles, like
  199. where's my pen and I am out of paper, every time a guru pops up.
  200.  
  201.  
  202. Bugs
  203. =====
  204.  
  205.    DaLastAlert 3 have been tested on these configurations:
  206.  
  207. `Amiga 2000'
  208.      A2000, GVP G-Force 030 50MHz, MMU, FPU
  209.  
  210. `Amiga 1200'
  211.      2 MB CHIP.
  212.  
  213. `Amiga 1200'
  214.      MBX1200Z, 2 MB CHIP, 4 MB FAST.
  215.  
  216. `Amiga 1200'
  217.      BLIZZARD 1220/4 28.5MHz, NO FPU, 2 MB CHIP, 4 MB FAST.
  218.  
  219. `Amiga 1200'
  220.      M1230XA 40MHz, NO MMU, NO FPU, 2 MB CHIP, 8 MB FAST, Overdrive HD.
  221.  
  222. `Amiga 1200'
  223.      M1230XA 50MHz, MMU, NO FPU, 2 MB CHIP, 8 MB FAST (My Amiga).
  224.  
  225.    I cannot find any (more) bugs in DaLastAlert 3 but i am sure you
  226. can. If you find a bug PLEASE fillout the bugreport formular below
  227. (orginal made by Dave Haynie) and send it to me (see About for address).
  228.  
  229. Bugreport
  230. ---------
  231.  
  232.      Your Configuration:
  233.      
  234.        [] A500     []A1000     []A2500      []A1200      []CDTV/CD32
  235.        [] A600     []A2000     []A3000      []A4000      []Other
  236.      
  237.        KS Version___________   RAM__________   Other HW__________________
  238.      
  239.        WB Version___________   HD___________   HD Controller_____________
  240.      
  241.      Please explain the problem as completely as possible:
  242.      
  243.        File System Version/Type__________________________________________
  244.      
  245.        ScreenMode________________________  Font__________________________
  246.      
  247.        []Shell/CLI     []Workbench         Locale________________________
  248.      
  249.        Problem:   []Full Lockup    []GURU/Crash
  250.      
  251.        Steps to see this problem?________________________________________
  252.      
  253.        __________________________________________________________________
  254.      
  255.        __________________________________________________________________
  256.      
  257.      
  258.        Other Comments____________________________________________________
  259.      
  260.        __________________________________________________________________
  261.      
  262.        __________________________________________________________________
  263.      
  264.      
  265.        Bug found by (address)____________________________________________
  266.      
  267.        __________________________________________________________________
  268.      
  269.        __________________________________________________________________
  270.  
  271. Note
  272. ----
  273.  
  274.    If you have Enforcer active while running DaLastAlert 3 you will get
  275. some 'Enforcer Hits' because DaLastAlert 3 makes LONG-READs at $100 and
  276. $104.( This is no BUG :P ).
  277.  
  278.  
  279. Program History
  280. ================
  281.  
  282. Version 1.0
  283. -----------
  284.  
  285.    * First release. (And it works on Kickstart and Workbench 3.0)
  286.  
  287.    * Only tested on a A1200 with different configurations with Kickstart
  288.      and Workbench 3.0
  289.  
  290. Version 2.0
  291. -----------
  292.  
  293.    * Now LastAlert also shows: Alert Number, Alert Task, Alert Name,
  294.      Spec. Alert, Spec. Error.
  295.  
  296.    * Still not tested on a Kickstart and Workbench 2.0 system!
  297.  
  298. Version 2.1
  299. -----------
  300.  
  301.    * First public release (Aminet).
  302.  
  303.    * A little bug fixed !!!
  304.  
  305. Version 3.0a
  306. ------------
  307.  
  308.    * Only released to two ßetatesters.
  309.  
  310.    * Changed the name from LastAlert to DaLastAlert.
  311.  
  312.    * Totally rewritten code (Now using Amiga E by Wouter van
  313.      Oortmerssen).
  314.  
  315.    * Now two programs.
  316.  
  317.         * A small starter program (DaLastAlert3-Check).
  318.  
  319.         * A 'big' main program (DaLastAlert3).
  320.  
  321.    * Now with a totally cool GUI (EasyGUI - Wouter van Oortmerssen).
  322.  
  323.         * Totally Font-Sensitive.
  324.  
  325.         * Resizable.
  326.  
  327.         * Etc.
  328.  
  329.    * And loads of other stuff....
  330.  
  331. Version 3.0b
  332. ------------
  333.  
  334.    * Added an alert file (S:DaLastAlert3.alerts).
  335.  
  336.    * Added an environment var. (ENV:DaLastAlert3).
  337.  
  338.    * Cleanedup source code.
  339.  
  340.    * Made Error-handling better (PrintF->EzReq).
  341.  
  342.    * Minor GUI design error corrected (COLS->EQCOLS).
  343.  
  344.    * Added requester titles.
  345.  
  346.    * Changed About text.
  347.  
  348. Version 3.0c
  349. ------------
  350.  
  351.    * First Public Release of DaLastAlert 3 (Aminet).
  352.  
  353.  
  354. About
  355. ======
  356.  
  357. Address
  358. -------
  359.  
  360.    If you want to contact the author of this program then write to this
  361. address:
  362.  
  363.                  Mail:   Jørgen 'Da' Larsen (Posse Pro. DK)
  364.                          Carl Blochs Vej 20
  365.                          9000 Aalborg
  366.                          Denmark
  367.      
  368.                  E-mail: dapp@iesd.auc.dk
  369.  
  370. Or try my WWW-Homepage:
  371.  
  372.                  URL:    http://nano.iesd.auc.dk/80/~dapp/
  373.  
  374. Note
  375. ----
  376.  
  377.    Please write if you have some remarks, suggestions or if you have
  378. found some bugs in the program (you are also welcome to send me a
  379. modem, bike, FPU, car, house or maybe just a note saying that you like
  380. the program).
  381.  
  382. Credits
  383. -------
  384.  
  385. `Søren Staun-Pedersen'
  386.      ßetatester.   The maker of DaLastAlert3-Check and DaLastAlert3
  387.      icons.
  388.  
  389. `Claus Nyhus Chr.'
  390.      ßetatester
  391.  
  392. `Anders F.'
  393.      ßetatester
  394.  
  395. `Wouter van Oortmerssen'
  396.      Amiga E, EDBG, EasyGUI....
  397.  
  398. Greetings ( Randomized )
  399. ------------------------
  400.  
  401.    * Søren Staun-Pedersen - No 'REAL' computer!!
  402.  
  403.    * Claus Nyhus Chr.     - Get E'ing
  404.  
  405.    * Anders S. Elkjær     - NO computer ehh!!
  406.  
  407.    * Anders F.            - I am waiting for the MegaDemo II
  408.  
  409.    * Mogens C. Larsen     - Amiga Power!!!!!
  410.  
  411.    * Flemming Kjær Jensen - Always the MAC
  412.  
  413.    * Frank 'Dux' Busborg  - Amosazing
  414.  
  415.    * Jens K. Jensen       - Party on ..
  416.  
  417.    * Esben S. Omething    - Hello!!
  418.  
  419.    * Yeko                 - Hold the line!!
  420.  
  421.    * Frostie              - JOE 'Tekkno Sumpen'
  422.  
  423.    * Preben Nielsen       - What a cruel asm coder!!
  424.  
  425.    * Bent D. Olsen        - Thanks for your letter
  426.  
  427.    * SuperTrade DK        - The 'best' Amiga shop - Yo Alex H.
  428.  
  429.    * Amiga Shopper        - Great inspiration, testing LA2
  430.  
  431.    * +ALL AMIGA OWNERS
  432.  
  433.  
  434. What Amiga Shopper wrote about LastAlert2
  435. ==========================================
  436.  
  437.    Amiga Shopper wrote the following about LastAlert2 in issue 46
  438. (February 1995):
  439.  
  440.                               ----------
  441.  
  442. From Subscripers coverdisk description:
  443.  
  444.    "LastAlert2 is very useful utility indeed.  It will tell you the
  445. Guru number of your machine after it has crashed.  Once the folder has
  446. been unarchived double-click on the install icon and the files will be
  447. copied to the appropriate directories. By default LastAlert2 will be
  448. copied to your WBStartup drawer. This means that if you machine crashes
  449. the program will be run as soon as the machine resets. It will produce
  450. a requester that informs of number the offending Guru."
  451.  
  452.                               ----------
  453.  
  454. From inside the magazine on page 78:
  455.  
  456.    "If there is one thing that is guaranteed to turn even the most sane
  457. Amiga-user into to an irrational, salivating wild beast it's a system
  458. crash. When this happens it's a good idea to make a note of the guru
  459. number that is flashed on screen. Unfortunately the average human is
  460. unlikely to be in a state of mind that will facilitate the execution of
  461. such a complex action. During these moments of debilitating rage you
  462. will certainly benefit from a program like LastAlert2.
  463.  
  464.    LastAlert2 is a Wb2+ program that will record the last message
  465. displayed by you machine. This will give you the opportunity to take
  466. note of this number while you are in a more... chemically balanced
  467. state-of-mind."
  468.  
  469.